home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / cmscreategamutcheck.z / cmscreategamutcheck
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccmmmmssssCCCCrrrreeeeaaaatttteeeeGGGGaaaammmmuuuuttttCCCChhhheeeecccckkkk((((3333))))               CCCCMMMMSSSS                ccccmmmmssssCCCCrrrreeeeaaaatttteeeeGGGGaaaammmmuuuuttttCCCChhhheeeecccckkkk((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cmsCreateGamutCheck - creates a gamut check from a set of profiles
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ccccmmmmssss....hhhh>>>>
  13.  
  14.      iiiinnnntttt33332222 ccccmmmmssssCCCCrrrreeeeaaaatttteeeeGGGGaaaammmmuuuuttttCCCChhhheeeecccckkkk ((((ccccttttxxxxtttt,,,, pppprrrrooooffffiiiilllleeeeCCCCoooouuuunnnntttt,,,, pppprrrrooooffffssss,,,, ccccmmmmmmmm,,,, ppppttttffffmmmm))));;;;
  15.      CCCCMMMMSSSSCCCCoooonnnntttteeeexxxxtttt ccccttttxxxxtttt;;;;
  16.      iiiinnnntttt33332222 pppprrrrooooffffiiiilllleeeeCCCCoooouuuunnnntttt;;;;
  17.      CCCCMMMMSSSSPPPPrrrrooooffffiiiilllleeee ****pppprrrrooooffffssss;;;;
  18.      iiiiccccSSSSiiiiggggnnnnaaaattttuuuurrrreeee ccccmmmmmmmm;;;;
  19.      CCCCMMMMSSSSTTTTffffmmmm ****ppppttttffffmmmm;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _c_m_s_C_r_e_a_t_e_G_a_m_u_t_C_h_e_c_k uses a color manipulation module (CMM) to create a
  23.      gamut check out of a list of profiles.  The resulting gamut check
  24.      simulates a sequential execution of the algorithms implied by the
  25.      individual profiles, starting from the first profile and ending in the
  26.      last profile, and then indicates whether the pixels resulting from that
  27.      transform are reproduceable on the device indicated by the final profile.
  28.      See  cmsCheckGamut for an explanation of the results of applying a gamut
  29.      check.
  30.  
  31.      Different CMMs will produce different transforms from the same set of
  32.      profiles.  The transforms will yield different results when applied a
  33.      given set of pixels.  Application writers may wish to control which CMM
  34.      is used to create and apply a transform.  Accordingly, they will wish to
  35.      use the same CMM when checking the reproducibility of colors.  They may
  36.      do so by specifying the CMM's name with the _c_m_m parameter.  The list of
  37.      supported CMMs is returned from the command _c_m_s_G_e_t_C_m_m_L_i_s_t.  Application
  38.      writers who have no preference as to the CMM used may do one of two
  39.      things. They may specify that the system's default CMM be used by setting
  40.      _c_m_m to _C_M_S__U_S_E__D_E_F_A_U_L_T__C_M_M.  Each profile in the list _p_r_o_f_s may specify a
  41.      preferred CMM in its header.  If the application writer sets _c_m_m to
  42.      _C_M_S__U_S_E__P_R_O_F_I_L_E__C_M_M, then the CMS goes through the list of profiles from
  43.      last to first and lets each specified CMM try to build the transform.  If
  44.      the CMM can build the transform, the result is used, and that CMM will be
  45.      used to apply the transform.  If the CMM cannot build the tranform, the
  46.      next one in order will be tried. If not of the CMMs can build the
  47.      tranform, _c_m_s_C_r_e_a_t_e_T_f_m returns an error.  The reason the list is
  48.      traversed backward is that output devices tend to be at the end of the
  49.      profile list, and it is the profiles of output devices that tend to have
  50.      the most dramatic effects on a tranform.
  51.  
  52. EEEERRRRRRRROOOORRRRSSSS
  53.      CMS_OUT_OF_MEMORY
  54.                There is not enough memory available to create a gamut check.
  55.  
  56.      CMS_WRONG_DATA
  57.                The ctxt points to something that is not a context.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccmmmmssssCCCCrrrreeeeaaaatttteeeeGGGGaaaammmmuuuuttttCCCChhhheeeecccckkkk((((3333))))               CCCCMMMMSSSS                ccccmmmmssssCCCCrrrreeeeaaaatttteeeeGGGGaaaammmmuuuuttttCCCChhhheeeecccckkkk((((3333))))
  71.  
  72.  
  73.  
  74.      CMS_BAD_ENCODE
  75.  
  76.      CMS_BAD_CONTEXT
  77.  
  78.      CMS_TOO_MANY_CHANNELS
  79.                The CMM cannot support a gamut check with the requested number
  80.                of channels.
  81.  
  82.      CMS_CMM_NOT_AVAILABLE
  83.                The requested CMM is not available.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      cmsCheckGamut, cmsCreateTfm
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.